Pause -- wait for keypress

Syntax      Pause [prompt]

Description Pause displays a prompt on the screen and then waits for a
            keypress.  If the 'prompt' argument is not supplied on the command
            line, the utility will use a default string as the prompt.

            After displaying the prompt, the program loops until a key is
            pressed.  If the keypress is a Command-., a status code of -1 is
            returned.  Any other keypress returns a status code of 0.

            This utility is most useful for inserting a pause into shell
            command files (EXEC files) which require some action by the user
            prior to continuation of the script.

Input       None

Output      Pause writes the prompt string to diagnostic output.  This is to
            ensure that the prompt string appears on the console device if
            standard output has been redirected.

Diagnostics None

Status      The following status codes may be returned:

            0   Any key besides Command-. has been pressed.

            -1  Command-. has been pressed, signifying that the user wishes to
                abort the script.

Options     A prompt string may be defined on the command line.  This prompt
            string will be displayed instead of the default prompt string.

Example:    The following lines appear in a backup script:

            .
            .
            .
            Copy -c /Hard.Drive/APW/Source/= /Source.Backup
            Pause Please insert the /Object.Backup disk...
            Copy -c /Hard.Drive/APW/Objects/= /Object.Backup
            .
            .
            .
